home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / edit / versedit.zip / MANUAL.VE < prev    next >
Text File  |  1990-03-30  |  92KB  |  2,732 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.                                   V E R S A E D I T
  25.  
  26.  
  27.                                      Version 1.2A
  28.  
  29.  
  30.  
  31.                                     USER'S MANUAL
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.                                    Szachna Spirytus
  42.  
  43.                               3705 S. George Mason Drive
  44.                                       No. 2517-S
  45.                                 Falls Church, VA 22041
  46.  
  47.                                     (703)931-9398
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.                                        LICENSE
  56.  
  57.  
  58.           Copyright (C)  1990 Szachna Spirytus.  All  rights reserved world
  59.           wide.   Both  the   VersaEdit  program   and  documentation   are
  60.           copyrighted.  Disassembly  or  modification without  our  express
  61.           written consent is prohibited.
  62.  
  63.           Non-registered  users  are  granted  a  limited  license  to  use
  64.           VersaEdit on a trial basis for the purpose of determining whether
  65.           VersaEdit is suitable for their needs.   Use of VersaEdit, except
  66.           for  this limited purpose,  requires registration.   Use  of non-
  67.           registered   copies  of   VersaEdit  by  any   person,  business,
  68.           corporation, governmental agency or other entity is prohibited.
  69.  
  70.           Registration permits a user the license  to use VersaEdit only on
  71.           a single  computer; a registered  user may  use the program  on a
  72.           different computer, but may not use the program  on more than one
  73.           computer at the same time.
  74.  
  75.           All users are  granted a limited  license to copy VersaEdit  only
  76.           for the trial use of others subject to the above limitations, and
  77.           also the following:
  78.  
  79.                Copies of  VersaEdit must  be in  unmodified form,  complete
  80.                with the file containing this license information.
  81.  
  82.                The full VersaEdit  documentation must be included  with the
  83.                copy.
  84.  
  85.                No fee, charge or other  compensation for VersaEdit software
  86.                or  documentation  may  be  requested  or  accepted  by  any
  87.                licensee without our written approval.
  88.  
  89.                VersaEdit or it's  documentation may  not be distributed  in
  90.                connection with any commercial venture, product, publication
  91.                or service without our written approval.
  92.  
  93.                Operators of electronic bulletin board systems (Sysops)  may
  94.                post VersaEdit for downloading by their users only under the
  95.                above conditions.
  96.  
  97.                Distributors of  shareware software may distribute copies of
  98.                VersaEdit  subject  to  the  above  conditions   only  after
  99.                obtaining our written  approval.   Such approval usually  is
  100.                granted; please write or call for details.
  101.  
  102.                See   the  Registration  section  for  more  information  on
  103.                registration, corporate licensing and similar topics.
  104.  
  105.  
  106.  
  107.  
  108.                                           i
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.           Disclaimer of Warranty and Limitation of Liability. 
  117.            
  118.           SZACHNA SPIRYTUS ("LICENSOR")  MAKES NO WARRANTY ON  SOFTWARE AND
  119.           ACCOMPANYING DOCUMENTATION  AS TO ITS  PERFORMANCE, ACCURACY,  OR
  120.           FREEDOM FROM ERROR,  OR AS TO  ANY RESULTS GENERATED THROUGH  ITS
  121.           USE, INCLUDING,  WITHOUT LIMITATION,  ANY  IMPLIED WARRANTIES  OF
  122.           MERCHANTABILITY OR OF FITNESS  FOR A PARTICULAR PURPOSE,  AND YOU
  123.           ASSUME THE  ENTIRE RISK AS TO THE  RESULTS AND PERFORMANCE OF THE
  124.           SOFTWARE.    LICENSOR  SPECIFICALLY  DOES  NOT WARRANT  THAT  THE
  125.           SOFTWARE   AND   ACCOMPANYING   DOCUMENTATION   WILL  MEET   YOUR
  126.           REQUIREMENTS OR OPERATE WITHOUT INTERRUPTION OR ERROR.
  127.            
  128.           LICENSOR WILL NOT BE LIABLE FOR ANY AND ALL CLAIMS ARISING OUT OF
  129.           OR IN CONNECTION WITH  THE SOFTWARE, WHETHER MADE OR  SUFFERED BY
  130.           YOU OR ANY OTHER PERSON,  AND WHETHER BASED IN CONTRACT  OR TORT.
  131.           UNDER  NO  CIRCUMSTANCES,  WHETHER  IN  CONTRACT OR  TORT,  SHALL
  132.           LICENSOR NOR ANYONE ELSE  WHO HAS BEEN INVOLVED IN  THE CREATION,
  133.           PRODUCTION,  OR DELIVERY OF  THE SOFTWARE, BE  LIABLE FOR DIRECT,
  134.           INDIRECT, CONSEQUENTIAL,  SPECIAL, OR  EXEMPLARY DAMAGES  SUCH AS
  135.           BUT  NOT  LIMITED TO  LOSS  OF  REVENUE OR  ANTICIPATED  PROFITS,
  136.           BUSINESS  INTERRUPTION,   LOSS  OF  BUSINESS   INFORMATION,  LOST
  137.           BUSINESS OR OTHER ECONOMIC  LOSS ARISING OUT OF OR  IN CONNECTION
  138.           WITH THIS  AGREEMENT EVEN  IF LICENSOR  HAS BEEN  ADVISED OF  THE
  139.           POSSIBILITY OF  SUCH DAMAGES.   IN  ANY EVENT,  ANY LIABILITY  OF
  140.           LICENSOR OUT OF OR IN CONNECTION WITH THIS AGREEMENT OR YOUR  USE
  141.           OR INABILITY TO  USE THE SOFTWARE,  WHETHER BASED IN CONTRACT  OR
  142.           TORT, SHALL NOT EXCEED  THE AMOUNT YOU PAID,  IF ANY, TO  LICENSE
  143.           THE SOFTWARE. 
  144.  
  145.           SOME STATES DO NOT  ALLOW THE EXCLUSION OR LIMITATION  OF IMPLIED
  146.           WARRANTIES OR OF INCIDENTAL OR CONSEQUENTIAL DAMAGES SO THE ABOVE
  147.           LIMITATION OR EXCLUSION MAY NOT APPLY TO YOU.
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.                                           ii
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.                                REGISTRATION INFORMATION
  178.  
  179.  
  180.           A VersaEdit registration  licenses you  to use the  product on  a
  181.           regular  basis.   Registration  includes  mailed notification  of
  182.           updates and  technical  support.    Individual  registration  for
  183.           VersaEdit costs $29.  A diskette containing the latest version of
  184.           the program with  complete set of  support files costs $10.   The
  185.           diskette is not needed if you already have the latest version.
  186.  
  187.           Please use the enclosed registration form when placing an order.
  188.  
  189.           OUTSIDE OF THE USA:  Send check drawn on US bank  in US currency,
  190.           or otherwise add $8 for collection.
  191.  
  192.  
  193.                            Corporate and Quantity Purchases
  194.  
  195.  
  196.           All corporate, business, government or  other commercial users of
  197.           VersaEdit  must  be  registered.    Please  write   or  call  for
  198.           information concerning corporate licensing agreements.
  199.  
  200.           We  accept purchase orders in amounts  over $100 only.  All other
  201.           orders should be prepaid.
  202.  
  203.  
  204.  
  205.           ALL PRICES AND DISCOUNTS ARE SUBJECT TO CHANGE WITHOUT NOTICE.  
  206.  
  207.  
  208.           WARNING:  YOU  MAY  NOT USE  VERSAEDIT  WITHIN  YOUR ORGANIZATION
  209.           WITHOUT A PRIOR REGISTRATION OR LICENSE ARRANGEMENT.
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.                                          iii
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.                              VERSAEDIT REGISTRATION FORM
  239.  
  240.  
  241.  
  242.  
  243.  
  244.           Remit to:                Szachna Spirytus
  245.                                3705 S. George Mason Dr.
  246.                                       No. 2517-S
  247.                                 Falls Church, VA 22041
  248.  
  249.                                     (703)931-9398
  250.  
  251.  
  252.  
  253.           ___ VersaEdit Registration    @ $29.00 ea  ____ users    $ ______
  254.  
  255.           ___ Latest Version Diskette*    $10.00                   $ ______
  256.  
  257.                                                         Subtotal   $ ______
  258.  
  259.                                                    Less Discount   $ ______
  260.  
  261.           Virginia residents please add 4.5% sales tax       Tax   $ ______
  262.  
  263.                                                            Total   $ ______
  264.  
  265.  
  266.           Payment by:              ( ) check  ( ) PO # ____________________
  267.  
  268.           Name:     _______________________________________________________
  269.  
  270.           Title:    _______________________________________________________
  271.  
  272.           Company:  _______________________________________________________
  273.  
  274.           Address:  _______________________________________________________
  275.  
  276.                     _______________________________________________________
  277.  
  278.                     _______________________________________________________
  279.  
  280.           Phone:    _______________________________________________________
  281.  
  282.           Version:  1.2A
  283.  
  284.  
  285.           OUTSIDE OF  THE USA: Send check drawn on  US bank in US currency,
  286.           or otherwise add $8 for collection.
  287.  
  288.  
  289.           *   Only 5.25 inch DS/DD diskettes are available at this time.
  290.  
  291.                                           iv
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.                                   TABLE OF CONTENTS
  308.  
  309.  
  310.  
  311.           SECTION 1.  Overview  . . . . . . . . . . . . . . . . . . . .   1
  312.                1.1.  Introducing VersaEdit  . . . . . . . . . . . . . .   1
  313.                1.2.  Minimum System Requirements  . . . . . . . . . . .   2
  314.                1.3.  Terminology and Notation Conventions . . . . . . .   2
  315.                1.4.  Getting Started  . . . . . . . . . . . . . . . . .   3
  316.  
  317.           SECTION 2.  VersaEdit Commands  . . . . . . . . . . . . . . .   6
  318.                2.1.  Cursor Movement Commands . . . . . . . . . . . . .   8
  319.                2.2.  Text Movement Commands . . . . . . . . . . . . . .   9
  320.                2.3.  Text Edit Commands . . . . . . . . . . . . . . . .  10
  321.                2.4.  Menu Commands  . . . . . . . . . . . . . . . . . .  11
  322.                2.5.  Command Argument Edit Commands . . . . . . . . . .  13
  323.                2.7.  Find/Replace Commands  . . . . . . . . . . . . . .  17
  324.                2.8.  Cut & Paste Commands . . . . . . . . . . . . . . .  20
  325.                2.9.  Miscellaneous Commands . . . . . . . . . . . . . .  21
  326.  
  327.           SECTION 3.  VersaEdit Parameters  . . . . . . . . . . . . . .  23
  328.                3.1.  Display Attributes/Colors Submenu  . . . . . . . .  24
  329.                3.2.  Other Display Parameters Submenu . . . . . . . . .  26
  330.                3.3.  Print Parameters Submenu . . . . . . . . . . . . .  28
  331.                3.4.  File Formatting Parameters Submenu . . . . . . . .  29
  332.                3.6.  Save New Setup Entry . . . . . . . . . . . . . . .  34
  333.  
  334.           Appendix A.    Assignment of  Function Keys to  Commands, by
  335.                          Command Category . . . . . . . . . . . . . . .  35
  336.  
  337.           Appendix B.    Assignment of  Function Keys to  Commands, by
  338.                          Key  . . . . . . . . . . . . . . . . . . . . .  36
  339.  
  340.           Index . . . . . . . . . . . . . . . . . . . . . . . . . . . .  37
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.                                           v
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.                                     LIST OF TABLES
  378.  
  379.  
  380.           Table 2.1.1.  Cursor Movement Commands Summary  . . . . . . .   8
  381.           Table 2.2.1.  Text/Window Movement Command Summary  . . . . .   9
  382.           Table 2.3.1.  Text Edit Command Summary . . . . . . . . . . .  10
  383.           Table 2.4.1.  Menu Command Summary  . . . . . . . . . . . . .  11
  384.           Table 2.5.1.  Command Argument Prompt Editing Summary . . . .  13
  385.           Table 2.6.1.  File Commands Summary . . . . . . . . . . . . .  15
  386.           Table 2.7.1.  Find/Replace Command Summary  . . . . . . . . .  17
  387.           Table 2.7.2.  Find/Replace Parameter Menu Facsimile . . . . .  19
  388.           Table 2.8.1.  Cut & Paste Command Summary.  . . . . . . . . .  20
  389.           Table 2.9.1.  Miscellaneous Command Summary . . . . . . . . .  21
  390.           Table 3.2.1.  Other Display Parameters  . . . . . . . . . . .  26
  391.           Table 3.3.1.  Print Parameters  . . . . . . . . . . . . . . .  28
  392.           Table 3.4.1.  Initial File Format Parameter Settings  . . . .  31
  393.           Table 3.5.1.  Other Parameters  . . . . . . . . . . . . . . .  32
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.                                           vi
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.                                 SECTION 1.  Overview.
  422.  
  423.  
  424.           1.1.  Introducing VersaEdit.
  425.  
  426.           VersaEdit was created  specifically to  enable PC programmers  to
  427.           effectively create, maintain,  and manipulate source code  files.
  428.           While  the VersaEdit design was influenced  by other software, it
  429.           was not based on any existing program editor.  Instead, VersaEdit
  430.           was  designed from  scratch to  conveniently accommodate  program
  431.           editing tasks in the PC environment.
  432.  
  433.           The human interface is  designed to make all the  commands easily
  434.           accessible for both novice and power users.  This is accomplished
  435.           by the  use of  a menu  shell and  context sensitive  help.   The
  436.           commands can be  executed either  through the  menu or  directly.
  437.           The  commands are  assigned to  keys for  optimal use  of the  PC
  438.           keyboard.  The assignment adheres to the following pattern:
  439.  
  440.           o    The frequently used  commands are assigned to  the unshifted
  441.                function keys.
  442.           o    The File commands are assigned to the Ctrl shifted  function
  443.                keys.
  444.           o    The Find/Replace commands are assigned  to the Shift shifted
  445.                function keys.
  446.           o    The Cut &  Paste commands  are assigned to  the Alt  shifted
  447.                function keys.
  448.           o    The  miscellaneous  commands are  assigned to  the Remaining
  449.                shifted/unshifted function keys and  the Alt shifted  letter
  450.                keys.
  451.  
  452.           VersaEdit supports  all the existing  computer language  formats.
  453.           For  languages  that  use  line  numbers,  VersaEdit  strips  the
  454.           existing line numbers on input and  attaches its own line numbers
  455.           on  output.  VersaEdit does not  maintain line numbers.  Its line
  456.           number simply represents the  position of a line relative  to the
  457.           beginning of  the file (same as  in most compilers).   For format
  458.           sensitive  languages, VersaEdit  replaces the  initial spaces  by
  459.           tabs on input and replaces all the tabs by spaces on output.  The
  460.           indentations  are   controlled  by   tab  settings.     VersaEdit
  461.           determines  the  format  of a  specific  file  by  its file  name
  462.           extension.  All the  file format parameters can be  customized by
  463.           users.
  464.  
  465.           VersaEdit  supports  editing or  viewing  of  up  to eight  files
  466.           through up  to eight text  windows.   The windows  can be  either
  467.           horizontal or both horizontal and vertical.  The window sizes are
  468.           easily adjusted using the arrow keys.
  469.  
  470.           VersaEdit provides excellent directory support.  It also uses the
  471.           environment  variables  of  the  same  names  as  the  file  name
  472.           extensions to locate specific files.
  473.  
  474.                                           1
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.           The Cut &  Paste facility allows  easy file merges and  breakups.
  483.           The blocks of text can be easily exchanged among the files.
  484.  
  485.           The  Find/Replace facility  allows  searches in  both directions.
  486.           The user  can request  upper/lower case  sensitivity, replacement
  487.           confirmation, and other options.
  488.  
  489.           VersaEdit is easily customized through menus.  You can completely
  490.           change  its  appearance  by modifying  colors  and  other display
  491.           parameters.  You  can customize start-up defaults,  file formats,
  492.           printouts, cursor size, and many other elements.  VersaEdit works
  493.           well with memory resident keyboard macro utilities.  The keyboard
  494.           macro  utilities  can  be  used   to  change  the  command-to-key
  495.           assignments and to assign several commands to one key.
  496.  
  497.           VersaEdit has many other convenience features, including:
  498.  
  499.           o    Restoring Deleted or Modified Lines
  500.           o    EGA Large Display Support
  501.           o    Brace/Parenthesis/Bracket Balancing
  502.           o    Summary Display
  503.           o    Auto Indent
  504.           o    DOS Gateway
  505.           o    Print Support.
  506.  
  507.  
  508.           1.2.  Minimum System Requirements.
  509.  
  510.           VersaEdit requires an IBM PC or  compatible running under DOS 2.0
  511.           or higher with 320K of RAM.
  512.  
  513.  
  514.           1.3.  Terminology and Notation Conventions.
  515.  
  516.           The following symbols are  used to reference the shift  states of
  517.           command keys:
  518.  
  519.              ^ --   Control;  for example, ^F1  is achieved by pressing the
  520.                     Ctrl key simultaneously with the F1 key.
  521.  
  522.              a --   Alternate;  for  example, aF1  is achieved by  pressing
  523.                     the Alt key simultaneously with the F1 key.
  524.  
  525.              s --   Shift;   for example, sF1  is achieved by  pressing the
  526.                     Shift key simultaneously with the F1 key.
  527.  
  528.           The following  special ASCII  characters are  referenced in  this
  529.           manual:
  530.  
  531.              Carriage Return -- Hex 0D
  532.  
  533.              End of Line -- Also known as New Line and Line Feed, Hex 0A
  534.  
  535.                                           2
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.              Tab -- Hex 09.
  545.  
  546.           The  term  "wild  card characters"  refers  to  the  "*" and  "?"
  547.           characters,  which  have  the same  meaning  as  they  do in  DOS
  548.           context.  The  wild card characters  are used in specifying  file
  549.           names.  The term  "command argument" refers to  the supplementary
  550.           information needed  by a command.   For example,the  argument for
  551.           the Get File command would be the file name.
  552.  
  553.  
  554.           1.4.  Getting Started.
  555.  
  556.           The distribution diskette contains the following files:
  557.  
  558.           o    E.EXE, the executable program file.
  559.  
  560.           o    E.HLP, the help file that is used by the program.
  561.  
  562.           o    CLE.BAT,  a  sample batch  procedure  to compile,  link, and
  563.                execute a program.   In case  of compiler errors, the  batch
  564.                procedure executes VersaEdit  with the  source code file  in
  565.                the first  window, and  the compiler  errors  in the  second
  566.                window.  When  VersaEdit ends,  the batch procedure  resumes
  567.                the process from the beginning.
  568.  
  569.           o    MAK.BAT,  a sample  batch procedure  to  be used  instead of
  570.                CLE.BAT, when a Make Utility is used.
  571.  
  572.           o    AVGLINE.EXE,  a utility program  that determines the average
  573.                line length of  your source  code files.   The average  line
  574.                length is supplied to  VersaEdit via the Parameters Menu  in
  575.                order to fine tune the internal memory allocation.
  576.  
  577.                Syntax:  AVGLINE  file name  specifications, where  the file
  578.                name specifications are separated by  spaces and may contain
  579.                wild card characters.  For example, to determine the average
  580.                line  length  of  your  "C"  and  Header  files  in  current
  581.                directory enter:
  582.  
  583.                AVGLINE *.C *.H
  584.  
  585.                Supplying of the average line  length parameter to VersaEdit
  586.                is  not  required, but  is  recommended, especially  if your
  587.                lines are unusually long or short.
  588.  
  589.           It  is  important  to make  a  backup  copy  of the  distribution
  590.           diskette,  since  the  executable program  file  will  be changed
  591.           during the installation.
  592.  
  593.           After  the  backup,  the distribution  diskette  files  should be
  594.           copied to their permanent place of residence.
  595.  
  596.                                           3
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.           If you have a  fixed disk, we recommend that you  place VersaEdit
  605.           files into their own directory and  include this directory in the
  606.           PATH statement  in  the AUTOEXEC.BAT  file.   Assuming  that  the
  607.           distribution diskette is in drive A  and the destination drive is
  608.           C, the initial steps would be as follows:
  609.  
  610.           C:
  611.           MD \VE
  612.           CD \VE
  613.           COPY A:*.*
  614.  
  615.           This step can  be bypassed, if you  plan to run VersaEdit  from a
  616.           diskette.
  617.  
  618.           The rest of the installation process is performed from inside the
  619.           program   by  setting  the   appropriate  parameters   using  the
  620.           parameters menu.
  621.  
  622.           The syntax for executing VersaEdit is:
  623.  
  624.           E file name  specifications, where  the file name  specifications
  625.           are separated by spaces.  They  may contain wild card characters.
  626.           If  the  file  name specifications  are  omitted,  VersaEdit will
  627.           prompt you for them.
  628.  
  629.           The only mandatory part of the installation process  is providing
  630.           VersaEdit  with  the  full  file   name  specifications  for  the
  631.           executable program file and for the help file.  In order to speed
  632.           up the screen  updates, the  screen "snow" suppression  parameter
  633.           should be  turned off, unless there is  a problem with the screen
  634.           "snow".    If you  are  using  a memory  resident  keyboard macro
  635.           program, you may want  to turn off the cursor  run-on inhibition.
  636.           If this parameter  is left "ON",  your macros will require  delay
  637.           factors.  The  following is  a step  by step  description of  the
  638.           installation process.
  639.  
  640.           o    Press the sF10 key to bring up the Parameters Menu.
  641.  
  642.           o    To turn off the screen "snow" suppression:
  643.  
  644.                -    Use  the down  arrow key to  move the  menu bar  to the
  645.                     "Other Display Parameters" entry and press Enter.
  646.                -    Press  the up  arrow key  to move  the menu bar  to the
  647.                     "Suppress Snow" entry (the last entry) and press Enter.
  648.                     Press the Esc key to exit the submenu.
  649.  
  650.           o    Use the down  arrow key to move  the menu bar to  the "Other
  651.                Parameters" entry and press Enter.
  652.  
  653.           o    Optionally, use the  down arrow to move the menu  bar to the
  654.                "Cursor Run-on Inhibition" entry and press Enter.  This will
  655.                set the parameter to "OFF".
  656.  
  657.                                           4
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.           o    Use the down arrow key to move the menu bar to the "Exe File
  666.                Specification" entry and press Enter.
  667.  
  668.           o    Enter the full file name  specification, including the drive
  669.                and path, for the executable program file.
  670.  
  671.           o    Similarly, move down to the  "Help File Specification" entry
  672.                and  enter the  full  file name  specification for  the Help
  673.                File.
  674.  
  675.           o    Press the Esc key to go back to the Parameters Menu.
  676.  
  677.           o    Move down to the  last entry on the menu and  press Enter to
  678.                save the modified parameters.
  679.  
  680.           At this point, the help facility should be usable.  The remaining
  681.           parameters can be adjusted at a later time.
  682.  
  683.           VersaEdit can be used with minimal reference to this manual.  The
  684.           general guidelines are:
  685.  
  686.           o    Use the F1  key to get  help.   In the edit  mode, the  help
  687.                screens show the general information  and assignment of keys
  688.                to commands by command category.  To get help for a specific
  689.                command or parameter, press the F1 key either while pointing
  690.                to the command  or to the parameter on the menu, or from the
  691.                prompt for a command argument.
  692.  
  693.           o    If you prefer  not to use menus, use the menu shell (F2 key)
  694.                as a  command key reference, or use  it to learn the command
  695.                keys.
  696.  
  697.           o    Use the Esc key to cancel the current operation.
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.                                           5
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.           SECTION 2.  VersaEdit Commands.
  727.  
  728.  
  729.           This section is organized  as a command reference.   The commands
  730.           are divided into groups,  with a subsection for each group.  Each
  731.           subsection summarizes the command  group in the form of  a table,
  732.           showing command name, command key, and command function.  Further
  733.           information is provided where needed.
  734.  
  735.           VersaEdit utilizes one logical key per command.  All the commands
  736.           are  assigned  to either  function keys  or  special keys  on the
  737.           numeric keyboard pad, with the following exceptions:
  738.  
  739.           o    The Auto Indent  toggle switch, assigned  to the aA (Alt  A)
  740.                key
  741.  
  742.           o    The Find Balancing  Parenthesis command, assigned to  the aB
  743.                key
  744.  
  745.           o    The Contract Window command, assigned to the aC key
  746.  
  747.           o    The Expand Window command, assigned to the aE key
  748.  
  749.           o    The DOS Gateway, assigned to the aD key
  750.  
  751.           o    The Vertical Screen Split toggle switch, assigned to  the aV
  752.                key.
  753.  
  754.           The  assignment  of commands  to  function  keys adheres  to  the
  755.           following guidelines:
  756.  
  757.           o    The frequently used commands -- Unshifted function keys
  758.  
  759.           o    The Find/Replace commands -- Shift shifted function keys
  760.  
  761.           o    The File commands -- Ctrl shifted function keys
  762.  
  763.           o    The Cut & Paste commands -- Alt  shifted function keys
  764.           o    The  miscellaneous  commands --  Remaining shifted/unshifted
  765.                function keys.
  766.  
  767.           Most of the VersaEdit commands can be executed in any one  of the
  768.           following ways:
  769.  
  770.           o    If the  command key  is known, by  pressing the  appropriate
  771.                key.
  772.  
  773.           o    If the  command key is not known, by  pressing the F2 key to
  774.                activate the menu  shell, selecting the appropriate  submenu
  775.                and pressing the command key shown on the submenu.
  776.  
  777.  
  778.  
  779.                                           6
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.           o    If the use of the menu is  preferred, by activating the main
  788.                menu, selecting the submenu, and  selecting the command from
  789.                the submenu.
  790.  
  791.           The  step  of invoking  the main  menu  can be  bypassed,  if the
  792.           submenu command key is known.
  793.  
  794.           The following commands are not on the menu:
  795.  
  796.           o    The Text and cursor movement commands, which are assigned to
  797.                the special keys on the numeric keyboard pad.
  798.  
  799.           o    The  Cancel  command  assigned  to  the  Esc  key,  which is
  800.                generally  used  to  cancel  the  current operation.    Some
  801.                examples  are canceling  menu/submenu/help  and canceling  a
  802.                command from the command argument prompt.   Pressing the Esc
  803.                key in  the edit mode  causes an  orderly abort of  the edit
  804.                session, after confirmation by the user.
  805.  
  806.           o    The  Insert Mode  Toggle command  assigned to  the Ins  key,
  807.                which toggles the insert mode between INSERT and OVERWRITE.
  808.  
  809.           o    The Delete  Character command assigned to the Del key, which
  810.                deletes the character under the cursor.
  811.           o    The Delete Character Left command assigned to the Back Space
  812.                key, which deletes the character to the left of the cursor.
  813.  
  814.           o    The Help command assigned to the F1 key, which activates the
  815.                help facility at any point of the edit session.
  816.  
  817.           o    The  Main  Menu  command  assigned  to  the  F2  key,  which
  818.                activates the main menu.
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.                                           7
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.           2.1.  Cursor Movement Commands.
  849.  
  850.           The cursor  movement  commands utilize  the special  keys on  the
  851.           right  side  of  the  keyboard,  adhering  to  the  customary  PC
  852.           convention.
  853.  
  854.                               Command
  855.           Command Name          Key       Command Function
  856.           --------------    ------------  --------------------------------
  857.  
  858.  
  859.           Column Left        Left Arrow   Move the cursor one column to the
  860.                                           left.
  861.  
  862.           Column Right      Right Arrow   Move the cursor one column to the
  863.                                           right.
  864.  
  865.           Row Up              Up Arrow    Move the cursor one row up.
  866.  
  867.           Row Down           Down Arrow   Move the cursor one row down.
  868.  
  869.           Word Left         ^Left Arrow   Move the cursor to  the beginning
  870.                                           of the word to the left.
  871.  
  872.           Word Right        ^Right Arrow  Move the cursor to  the beginning
  873.                                           of the word to the right.
  874.  
  875.           Home                  Home      Move the cursor  to the  leftmost
  876.                                           column, if pressed once. Move the
  877.                                           cursor to the  top left corner of
  878.                                           the window, if pressed twice.
  879.  
  880.           End                   End       Move the cursor to  the rightmost
  881.                                           column,  if  pressed once.   Move
  882.                                           the  cursor  to  the bottom  left
  883.                                           corner  of  window,   if  pressed
  884.                                           twice. Subsequent presses  of the
  885.                                           key  will  alternate  the  cursor
  886.                                           position   between   the   bottom
  887.                                           rightmost and the bottom leftmost
  888.                                           position.
  889.  
  890.                    Table 2.1.1.  Cursor Movement Commands Summary.
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.                                           8
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.           2.2.  Text Movement Commands.
  910.  
  911.           Adhering  to  the  customary  PC  convention, the  Text  Movement
  912.           commands generally utilize the special keys  on the right side of
  913.           the keyboard.    The exception  to the  rule is  the  Go To  Line
  914.           command.   It utilizes the F7 key and prompts the user for a line
  915.           number.
  916.  
  917.                               Command
  918.           Command Name          Key       Command Function
  919.           --------------    ------------  --------------------------------
  920.  
  921.  
  922.           Top of File          ^Home      Move up to the top of the file.
  923.  
  924.           End of File           ^End      Move down  to the  bottom of  the
  925.                                           file.
  926.  
  927.           Line Up              ^Pg Up     Move the  window one  line up  in
  928.                                           the text.
  929.  
  930.           Line Down            ^Pg Dn     Move the window one  line down in
  931.                                           the text.
  932.  
  933.           Page Up              Pg Up      Move up in the text by one window
  934.                                           length.
  935.  
  936.           Page Down            Pg Dn      Move  down  in  the  text by  one
  937.                                           window length.
  938.  
  939.           Go to Line             F7       If the line is not in the window,
  940.                                           move the window to  the specified
  941.                                           line. Position the cursor  at the
  942.                                           beginning of the line.
  943.  
  944.                  Table 2.2.1.  Text/Window Movement Command Summary.
  945.  
  946.           The Page Up  and the  Page Down commands  use the paging  overlap
  947.           parameter, which can be modified by the user.  See Section 3.3. 
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.                                           9
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.           2.3.  Text Edit Commands.
  971.  
  972.           The Auto Indent command  toggles the Auto Indent mode  between on
  973.           and off.  The Auto  Indent feature, when on, causes  VersaEdit to
  974.           copy the initial tab marks   from the previous line to every  new
  975.           line.  This results in an indentation on the new line that is the
  976.           same as that of the previous line.
  977.  
  978.                               Command
  979.           Command Name          Key       Command Function
  980.           --------------    ------------  --------------------------------
  981.  
  982.  
  983.           Insert Mode           Ins       Toggle  the  insert  mode between
  984.                                           INSERT and OVERWRITE.
  985.  
  986.           Auto Indent            aA       Toggle  the   Auto  Indent   mode
  987.                                           between "ON" and "OFF".
  988.  
  989.           D e l e t e           Del       Delete  the  character  under the
  990.           Character                       cursor.
  991.  
  992.           D e l e t e        Back Space   Delete the character to  the left
  993.           Character Left                  of the cursor.
  994.  
  995.           Insert Tab            Tab       Insert the Tab mark.
  996.  
  997.           Delete Line            F3       Delete the line at the cursor.
  998.  
  999.           D e l e t e            F4       Delete the remainder of  the line
  1000.           Remainder    of                 from the current cursor position.
  1001.           Line
  1002.  
  1003.           Insert Line            F5       Insert a blank line.
  1004.  
  1005.                        Table 2.3.1.  Text Edit Command Summary.
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014.  
  1015.  
  1016.  
  1017.  
  1018.  
  1019.  
  1020.  
  1021.  
  1022.  
  1023.                                           10
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031.           2.4.  Menu Commands.
  1032.  
  1033.  
  1034.                               Command
  1035.           Command Name          Key       Command Function
  1036.           --------------    ------------  --------------------------------
  1037.  
  1038.  
  1039.           Help                   F1       Activate  the  context  sensitive
  1040.                                           help.
  1041.  
  1042.           Main Menu              F2       Activate the Main Menu.
  1043.  
  1044.           File    Command       ^F1       Activate the File Command Menu.
  1045.           Menu
  1046.  
  1047.           Cut   &   Paste       aF1       Activate the Cut &  Paste Command
  1048.           Menu                            Menu.
  1049.  
  1050.           Find/Replace          sF1       Activate the Find/Replace Command
  1051.           Menu                            Menu.
  1052.  
  1053.           Utilities Menu        aF10      Activate  the  Utilities  Command
  1054.                                           Menu.
  1055.  
  1056.           Parameters Menu       sF10      Activate   the  Parameter   Setup
  1057.                                           Menu.
  1058.  
  1059.           Menu Bar Left      Left Arrow   Move the menu bar one position to
  1060.                                           the left.
  1061.  
  1062.           Menu Bar Right    Right Arrow   Move the menu bar one position to
  1063.                                           the right.
  1064.  
  1065.           Menu Bar Up         Up Arrow    Move  the  menu bar  one position
  1066.                                           up.
  1067.  
  1068.           Menu Bar Down      Down Arrow   Move  the  menu bar  one position
  1069.                                           down.
  1070.  
  1071.           First Entry           Home      Move the  menu bar  to the  first
  1072.                                           entry.
  1073.  
  1074.           Last Entry            End       Move  the menu  bar  to the  last
  1075.                                           entry.
  1076.  
  1077.           Exit   Menu  or       Esc       Exit the current menu or submenu.
  1078.           Submenu
  1079.  
  1080.                          Table 2.4.1.  Menu Command Summary.
  1081.  
  1082.  
  1083.  
  1084.                                           11
  1085.  
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.           VersaEdit uses a menu  shell.  The user can execute  the commands
  1093.           that are assigned to function keys and Alt shifted letters either
  1094.           through the menu or by pressing the appropriate key.  The command
  1095.           keys are also shown  on the menu.   For people who prefer not  to
  1096.           use the menus, it is still convenient to use the menu for looking
  1097.           up or learning the assignment of keys to the commands.
  1098.  
  1099.           The submenus  can be  activated directly  from the  edit mode  by
  1100.           pressing the appropriate command key.
  1101.  
  1102.           The setup of the  global parameters can be achieved  only through
  1103.           the menu.
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127.  
  1128.  
  1129.  
  1130.  
  1131.  
  1132.  
  1133.  
  1134.  
  1135.  
  1136.  
  1137.  
  1138.  
  1139.  
  1140.  
  1141.  
  1142.  
  1143.  
  1144.  
  1145.                                           12
  1146.  
  1147.  
  1148.  
  1149.  
  1150.  
  1151.  
  1152.  
  1153.           2.5.  Command Argument Edit Commands.
  1154.  
  1155.                               Command
  1156.           Command Name          Key       Command Function
  1157.           --------------    ------------  --------------------------------
  1158.  
  1159.  
  1160.           Insert                Ins       Toggle  the  insert  mode between
  1161.                                           INSERT and OVERWRITE.
  1162.  
  1163.           Delete                Del       Delete  the  character  under the
  1164.                                           cursor.
  1165.  
  1166.           Delete Left        Back Space   Delete the character to  the left
  1167.                                           of the cursor.
  1168.  
  1169.           Insert Tab            Tab       Insert the  Tab mark.   Used  for
  1170.                                           Find/Replace strings only.
  1171.  
  1172.           Help                   F1       Provide the  information in  this
  1173.                                           table,  followed  by  the context
  1174.                                           sensitive help  for the  original
  1175.                                           command.
  1176.  
  1177.           Find/Replace           F2       Activate     the     Find/Replace
  1178.           Parameters                      Parameter menu.
  1179.  
  1180.           Clear Line             F3       Clear the response line.
  1181.  
  1182.           Clear Remainder        F4       Clear   the   remainder   of  the
  1183.           of Line                         response line.
  1184.  
  1185.           Preserve String        F5       If  F5 is  the first  key pressed
  1186.                                           after  the  prompt,  it preserves
  1187.                                           the prompt  string.   Ineffective
  1188.                                           otherwise.
  1189.  
  1190.           Insert EOL             F6       Insert the End of  Line character
  1191.                                           (hex 0A).  Used  for Find/Replace
  1192.                                           strings only.
  1193.  
  1194.           Insert Esc             F7       Insert  the  Esc  character  (hex
  1195.                                           1B).
  1196.  
  1197.           Insert     Back        F8       Insert the  Back Space  Character
  1198.           Space                           (Hex 08).
  1199.  
  1200.           Insert CR              F9       Insert   the    Carriage   Return
  1201.                                           character (hex 0D).
  1202.  
  1203.                 Table 2.5.1.  Command Argument Prompt Editing Summary.
  1204.  
  1205.  
  1206.                                           13
  1207.  
  1208.  
  1209.  
  1210.  
  1211.  
  1212.  
  1213.  
  1214.           A command argument is the supplementary information required by a
  1215.           command.    For example,  a  command  argument for  the  Get File
  1216.           command would be the file name.
  1217.  
  1218.           If the command argument is needed, VersaEdit prompts the user for
  1219.           it  on  the message  line.    If an  applicable  previous command
  1220.           argument  is  available  or  there  is  a default  value,  it  is
  1221.           displayed on the  prompt line.  The user may choose to modify the
  1222.           displayed string or  provide a new one.  If a text key is pressed
  1223.           first, the displayed string  is cleared.  If the  cursor movement
  1224.           key is pressed first, the displayed  string is preserved.  The F5
  1225.           key can also be used to preserve the displayed string.
  1226.  
  1227.           The following special characters can be included in the
  1228.           Find/Replace  strings: Tab,  End of  Line, Esc,  Back Space,  and
  1229.           Carriage Return.  See Section 2.7.
  1230.  
  1231.           The command arguments are thoroughly validated.  Some of the file
  1232.           command argument errors  result in error  messages.  Most of  the
  1233.           errors are indicated by emission of a beep.
  1234.  
  1235.           Pressing the  Help key from the command  argument prompt, results
  1236.           in  the  Help display  for  the response  to the  prompt  and the
  1237.           specific help for the original command.
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.  
  1251.  
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259.  
  1260.  
  1261.  
  1262.  
  1263.  
  1264.  
  1265.  
  1266.  
  1267.                                           14
  1268.  
  1269.  
  1270.  
  1271.  
  1272.  
  1273.  
  1274.  
  1275.           2.6.  File Commands.
  1276.  
  1277.                               Command
  1278.           Command Name          Key       Command Function
  1279.           --------------    ------------  --------------------------------
  1280.  
  1281.           Get File              ^F2       Get a new file from disk and open
  1282.                                           a new window.
  1283.  
  1284.           Release File          ^F3       Close  the  current  window.   If
  1285.                                           there are no  other windows  open
  1286.                                           on the current file,  release the
  1287.                                           file from  memory without  saving
  1288.                                           it.
  1289.  
  1290.           Save Release          ^F4       Save  the  file  and   close  its
  1291.                                           window.   If there  are no  other
  1292.                                           windows open on the current file,
  1293.                                           release the file from memory.
  1294.  
  1295.           S a v e   B a k       ^F5       Change the file name extension of
  1296.           Release                         the file  on disk  to BAK.   Save
  1297.                                           the current version  of the  file
  1298.                                           under the original name and close
  1299.                                           its  window.    If  there are  no
  1300.                                           other windows open on the current
  1301.                                           file,  release   the  file   from
  1302.                                           memory.
  1303.  
  1304.           Save Only             ^F6       Save  the  file,  retain   it  in
  1305.                                           memory, and keep its window open.
  1306.  
  1307.           Write File            ^F7       Save the file  under a  different
  1308.                                           name,  retain  it in  memory, and
  1309.                                           keep its window open.
  1310.  
  1311.           Print File            ^F8       Print  the  entire  file  in  the
  1312.                                           VersaEdit format.
  1313.  
  1314.           Rename File           ^F9       Rename any file on disk.
  1315.  
  1316.           Delete File           ^F10      Delete any file on disk.
  1317.  
  1318.           Insert File           aF9       Insert   the   contents   of  the
  1319.                                           specified file above  the current
  1320.                                           line.
  1321.  
  1322.           Directory             sF7       Display   the    file   directory
  1323.                                           corresponding    to    the   user
  1324.                                           provided specification.
  1325.  
  1326.                          Table 2.6.1.  File Commands Summary.
  1327.  
  1328.                                           15
  1329.  
  1330.  
  1331.  
  1332.  
  1333.  
  1334.  
  1335.  
  1336.           The   file   name  specification   consists   of  a   disk  drive
  1337.           specification, path, file  name, and extension.   The  user  must
  1338.           provide,  at  minimum, a  file  name.   The  file  name extension
  1339.           defaults  to  the  value  of  the  Default  File  Name  Extension
  1340.           Parameter,  which  is  controlled through  the  Parameters  Menu.
  1341.           Other  omitted  parts of  the  file name  specification initially
  1342.           default to the logged on disk drive and path.  If the file is not
  1343.           found, VersaEdit  attempts to obtain  the missing parts  from the
  1344.           environment variable of the same name as the file name extension.
  1345.           If the attempt is not successful, either a new file on the logged
  1346.           on drive and  path is assumed, or  a "File not Found"  message is
  1347.           issued, depending on  the context.   The user supplied file  name
  1348.           specifications  are  checked for  validity  with the  issuance of
  1349.           appropriate  messages when  necessary.   For some errors,  only a
  1350.           beep is emitted.
  1351.  
  1352.           The Get  File, Directory, and  Insert File  commands accept  wild
  1353.           card characters  (* and ?) in the name  and extension part of the
  1354.           file  name  specification.   If a  wild  card character  is used,
  1355.           VersaEdit displays all the files  that match the specification in
  1356.           the menu format,  allowing the user to  choose one of  the files.
  1357.           VersaEdit and DOS interpret wild card characters in the same way.
  1358.  
  1359.           Prior  to  saving, the  Save  Bak  Release command  backs  up the
  1360.           original  version  of  the file  under  the  same  name with  the
  1361.           extension of BAK.  For  example, the file MAIN.C would  be backed
  1362.           up under the name of MAIN.BAK.
  1363.  
  1364.           The  Rename  File  and  Delete File  commands  perform  the  same
  1365.           functions  as  their  DOS  equivalents.   These  commands  can be
  1366.           applied to the files  being edited or to any other files.
  1367.  
  1368.           The Print File command prints an entire file in VersaEdit format.
  1369.           The setting of the print parameters is detailed in Section 3.3.
  1370.  
  1371.           The Directory command  results in  a menu format  display of  the
  1372.           file names that  match the user provided  specification, allowing
  1373.           the user  to  choose one  of the  files for  editing.   The  user
  1374.           provided  file   name  specification  must   contain  wild   card
  1375.           characters (*  and ?).   VersaEdit  and DOS  interpret wild  card
  1376.           characters in the same way.
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  
  1383.  
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.                                           16
  1390.  
  1391.  
  1392.  
  1393.  
  1394.  
  1395.  
  1396.  
  1397.           2.7.  Find/Replace Commands.
  1398.  
  1399.           The Find/Replace commands, other than the Find Block command, are
  1400.           driven by the Find/Replace parameters.  While each window has its
  1401.           own set of parameters, the find and replace strings are shared by
  1402.           all the open windows.
  1403.  
  1404.                               Command
  1405.           Command Name          Key       Command Function
  1406.           --------------    ------------  --------------------------------
  1407.  
  1408.  
  1409.           Find String           sF2       Find the user provided  string in
  1410.                                           the text.
  1411.  
  1412.           Find Block            sF3       Find   the   marked   block  (see
  1413.                                           Section 2.8).
  1414.  
  1415.           Replace String        sF4       Replace a user provided string by
  1416.                                           another user  provided string  in
  1417.                                           the text.
  1418.  
  1419.           R e p e a t           sF5       Repeat the  previous Find/Replace
  1420.           Find/Replace                    command for one occurrence of the
  1421.                                           string  (if  not  the Find  Block
  1422.                                           command).
  1423.  
  1424.                      Table 2.7.1.  Find/Replace Command Summary.
  1425.  
  1426.           The Find String and Replace String commands result in a prompt to
  1427.           supply the text strings.  The prompt displays the previously used
  1428.           string.   The user may  choose to modify it or  to discard it and
  1429.           provide  a new string.   A text  string may contain  Tabs, End of
  1430.           Line, Carriage Return, Esc,  and Back Space characters.   The end
  1431.           of line mark may appear only at the end of a find string.   If it
  1432.           appears in the find string, the end of line character must appear
  1433.           at the end of the replace  string.  If it does not appear  in the
  1434.           find string, the end  of line mark cannot  appear in the  replace
  1435.           string.    Entering  of an  invalid  string  will  result in  the
  1436.           emission of a beep.
  1437.  
  1438.           Use the  Tab key to enter  a tab, the F6  key to enter  an End of
  1439.           Line character, the F7 key to enter an Esc, the F8 key to enter a
  1440.           Back Space, and the F9 key  to enter a Carriage Return character.
  1441.           See  Section 2.5 for  further details concerning  the response to
  1442.           prompts for command arguments.
  1443.  
  1444.           If the Enter key is used to enter the last string, VersaEdit will
  1445.           perform the requested operation for one occurrence of the  string
  1446.           based on  the current parameter  settings.   Using the F2  key to
  1447.           enter the last  string will  activate the Find/Replace  Parameter
  1448.           Menu.
  1449.  
  1450.                                           17
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.  
  1457.  
  1458.           The  Repeat  Find/Replace  command  will  repeat  the  previously
  1459.           executed Find Block, Find  String, or Replace String command.   A
  1460.           Find String or a Replace String command will be executed for  one
  1461.           occurrence of the find string, using parameters and text  strings
  1462.           of the previously executed command.
  1463.  
  1464.           The Find String and Replace String commands perform their
  1465.           operations based on  the values  of the Find/Replace  Parameters.
  1466.           Table 2.7.2 lists the  parameters and their default values.   The
  1467.           parameters are set by using the Find/Replace Parameter Menu.  The
  1468.           menu is activated by pressing the F2 key instead of the Enter key
  1469.           to enter the last string.
  1470.  
  1471.           The parameters are set by either one of the following ways:
  1472.  
  1473.           o    Moving the menu bar to the desired position and pressing the
  1474.                Enter key
  1475.           o    Pressing one of the highlighted function keys
  1476.           o    Pressing one of the highlighted letter keys.
  1477.  
  1478.           The menu bar moves to the top (Begin Find/Replace) position after
  1479.           each parameter setting.  Then, pressing  the Enter key begins the
  1480.           Find/Replace operation.  The Esc key will cancel the Find/Replace
  1481.           command.
  1482.  
  1483.           The  Reset  to   Defaults  entry  resets  all   the  find/replace
  1484.           parameters to their default values.
  1485.  
  1486.           The Letter  Case Distinction  is an  on/off toggle  switch.   The
  1487.           initial default "OFF" setting causes VersaEdit to ignore the case
  1488.           of a letter (upper  or lower) during the search.
  1489.  
  1490.           The Direction is  an on/off  toggle switch.   The default  "down"
  1491.           setting causes  VersaEdit to  search the  text in  top to  bottom
  1492.           direction.  Change  of direction  automatically sets to  defaults
  1493.           and reverses the column and line ranges.
  1494.  
  1495.           The Line Range and  Column Range entries define  the area of  the
  1496.           text to be  searched.  The default values are:  "current to last"
  1497.           for lines and  "one to last" for  columns.  The user  is prompted
  1498.           for the beginning and ending line or column.  The line and column
  1499.           ranges  must be entered in reverse  order (ending to beginning as
  1500.           opposed to beginning to ending), if the search direction is "up".
  1501.           The program  prompt lists  the options  for response.   The  user
  1502.           response is checked for validity.  If  an error is encountered, a
  1503.           beep is emitted.
  1504.  
  1505.  
  1506.  
  1507.  
  1508.  
  1509.  
  1510.  
  1511.                                           18
  1512.  
  1513.  
  1514.  
  1515.  
  1516.  
  1517.  
  1518.  
  1519.                            Begin Search/Replace                
  1520.                       F2 - Reset to Defaults                   
  1521.                       F3 - leTter Case Distinction:  off       
  1522.                       F4 - Direction:                down      
  1523.                       F5 - Line Range:               curr/last 
  1524.                       F6 - Column Range:             1/last    
  1525.                       F7 - Number of Occurrences:    1         
  1526.                       F8 - conFirm Replacement:      off       
  1527.  
  1528.                  Table 2.7.2.  Find/Replace Parameter Menu Facsimile.
  1529.  
  1530.           The Confirm Replacement is  an on/off toggle switch.   It applies
  1531.           only to the replace operation.  It causes VersaEdit to prompt the
  1532.           user for confirmation of each text string replacement.
  1533.  
  1534.  
  1535.  
  1536.  
  1537.  
  1538.  
  1539.  
  1540.  
  1541.  
  1542.  
  1543.  
  1544.  
  1545.  
  1546.  
  1547.  
  1548.  
  1549.  
  1550.  
  1551.  
  1552.  
  1553.  
  1554.  
  1555.  
  1556.  
  1557.  
  1558.  
  1559.  
  1560.  
  1561.  
  1562.  
  1563.  
  1564.  
  1565.  
  1566.  
  1567.  
  1568.  
  1569.  
  1570.  
  1571.  
  1572.                                           19
  1573.  
  1574.  
  1575.  
  1576.  
  1577.  
  1578.  
  1579.  
  1580.           2.8.  Cut & Paste Commands.
  1581.  
  1582.           The Cut & Paste commands can be used to freely move or  copy text
  1583.           among the active files or to merge and break up files.
  1584.  
  1585.                               Command
  1586.           Command Name          Key       Command Function
  1587.           --------------    ------------  --------------------------------
  1588.  
  1589.  
  1590.           Mark Block            aF2       Mark  a  block  of  text  for   a
  1591.                                           subsequent cut & paste operation.
  1592.  
  1593.           Highlight Block       aF3       Toggle highlighting  of a  marked
  1594.                                           block between "ON" and "OFF".
  1595.  
  1596.           Copy Block            aF4       Copy  a  marked   block  to   the
  1597.                                           current cursor location.
  1598.  
  1599.           Delete Block          aF5       Delete a marked block.
  1600.  
  1601.           Move Block            aF6       Move  a  marked   block  to   the
  1602.                                           current cursor location.
  1603.  
  1604.           Print Block           aF7       Print a marked block in VersaEdit
  1605.                                           format.
  1606.  
  1607.           Write Block           aF8       Write a  marked block  to a  user
  1608.                                           specified file.
  1609.  
  1610.           Insert File           aF9       Insert a user specified file into
  1611.                                           the  file  in the  current window
  1612.                                           above the current line.
  1613.  
  1614.                       Table 2.8.1.  Cut & Paste Command Summary.
  1615.  
  1616.           The Mark Block command marks the beginning point of the block and
  1617.           prompts the   user to mark the  end point.   The cursor and  text
  1618.           movement commands are used to get to the end point of  the block.
  1619.           The  end point of  the block must be  located after the beginning
  1620.           point.
  1621.  
  1622.           The  newly marked  block stays highlighted until  highlighting is
  1623.           turned off by  the Highlight Block command or until  the block is
  1624.           used in a cut & paste operation.  The block will stay highlighted
  1625.           after a cut  & paste  operation until  any key is  pressed.   The
  1626.           High-light Block  command can be  used to toggle  highlighting at
  1627.           any time.
  1628.  
  1629.           If  the  marked block  consists  of  full lines,  the  Move Block
  1630.           command does not impose any additional memory overhead.
  1631.  
  1632.  
  1633.                                           20
  1634.  
  1635.  
  1636.  
  1637.  
  1638.  
  1639.  
  1640.  
  1641.           2.9.  Miscellaneous Commands.
  1642.  
  1643.                               Command
  1644.           Command Name          Key       Command Function
  1645.           --------------    ------------  --------------------------------
  1646.  
  1647.  
  1648.           Restore Line           F6       Restore  a  deleted  or  modified
  1649.                                           line.
  1650.  
  1651.           Go To Line             F7       Go to the line that is identified
  1652.                                           by a user specified line number.
  1653.  
  1654.           Go    To   Next        F8       Go to the  next window in top  to
  1655.           Window                          bottom, left to right direction.
  1656.  
  1657.           Open New Window        F9       Open a new window on the  current
  1658.                                           file.
  1659.  
  1660.           Display    Line       F10       Toggle  the  line  number display
  1661.           Numbers                         between "ON" and "OFF".
  1662.  
  1663.           Display  Memory       sF6       Display  the  memory  utilization
  1664.           Status                          statistics.
  1665.  
  1666.           Reset      Disk       sF8       Reset   the   Disk   Drives   for
  1667.           Drives                          changing diskettes.
  1668.  
  1669.           Summary Display       sF9       Display  the  lines that  are not
  1670.                                           indented.
  1671.  
  1672.           Auto Indent            aA       Toggle  the   Auto  Indent   mode
  1673.                                           between "ON" and "OFF".
  1674.  
  1675.           Find  Balancing        aB       Find  the balancing  parenthesis,
  1676.           Parenthesis                     brace, or bracket  for the one at
  1677.                                           the cursor.
  1678.  
  1679.           Contract Window        aC       Contract the current window.
  1680.  
  1681.           Expand Window          aE       Expand the current window.
  1682.  
  1683.           DOS Gateway            aD       Invoke the DOS shell.
  1684.  
  1685.           Vertical Screen        aV       Toggle the Vertical  Screen Split
  1686.           Split                           mode between "ON" and "OFF".
  1687.  
  1688.                      Table 2.9.1.  Miscellaneous Command Summary.
  1689.  
  1690.           The Restore Line command allows recovery of a deleted or modified
  1691.           line.  Once the  command is entered, VersaEdit displays  the last
  1692.           10  modified  or deleted  lines  in menu  format.   Each  line is
  1693.  
  1694.                                           21
  1695.  
  1696.  
  1697.  
  1698.  
  1699.  
  1700.  
  1701.  
  1702.           prefixed by its  line and  window number.   Windows are  numbered
  1703.           sequentially from one through eight.  The line to  be restored is
  1704.           selected by moving  the menu bar up  and down using the  Up Arrow
  1705.           and the Down Arrow keys.  Pressing the Enter key selects the line
  1706.           under  the  menu  bar.   The  selected  line is  inserted  in the
  1707.           position specified by its line and  window number prefix.  If the
  1708.           restored line number is greater than the number  of the last line
  1709.           in the file, the line is inserted at the end of the file.  If the
  1710.           restored line's window number  is greater than the number  of the
  1711.           last window, the line is inserted in the file in the last window.
  1712.  
  1713.           The Display Line Numbers command toggles the  line number display
  1714.           between "ON" and "OFF".  This command  in no way affects the file
  1715.           format.   Turning the line  numbers off causes   more text  to be
  1716.           visible.  In any case, the current line number is always shown on
  1717.           the message line.
  1718.  
  1719.           The Summary Display command  lists on the screen the  lines whose
  1720.           text starts in the  first column available for the  source module
  1721.           text.  In the "C" language files, this results in the list of all
  1722.           the function names that begin in  column 1.  In COBOL,  VersaEdit
  1723.           displays all lines that start in column 8.  Usually, this command
  1724.           results in a summary or outline type of a display.
  1725.  
  1726.           The  Contract  and Expand  Window commands  put the  program into
  1727.           Contract  or  Expand Window  mode.    The current  window  can be
  1728.           contracted or expanded by  use of the Left,  Right, Up, and  Down
  1729.           Arrow keys.   The Esc  key cancels  the contract or  expand mode.
  1730.           These commands are ineffective when only one window is open.
  1731.  
  1732.           The DOS Gateway Command invokes the DOS  shell.  Use the DOS Exit
  1733.           command to return to VersaEdit.
  1734.  
  1735.           The Vertical  Screen Split  command toggles  the vertical  screen
  1736.           split mode  between "ON" and  "OFF".   When "ON",  the screen  is
  1737.           split both vertically and horizontally.  Otherwise, the screen is
  1738.           split only horizontally.
  1739.  
  1740.  
  1741.  
  1742.  
  1743.  
  1744.  
  1745.  
  1746.  
  1747.  
  1748.  
  1749.  
  1750.  
  1751.  
  1752.  
  1753.  
  1754.  
  1755.                                           22
  1756.  
  1757.  
  1758.  
  1759.  
  1760.  
  1761.  
  1762.  
  1763.           SECTION 3.  VersaEdit Parameters.
  1764.  
  1765.  
  1766.           The  global  parameter  settings  can   be  changed  through  the
  1767.           VersaEdit menu  facility.  The  Parameters Menu can  be activated
  1768.           either directly by  pressing the  sF10 key or  by activating  the
  1769.           main menu, followed by selection of the Parameters entry.
  1770.  
  1771.           The Parameters Menu contains the following entries:
  1772.  
  1773.           o    Display Attributes/Colors Submenu
  1774.           o    Other Display Parameters Submenu
  1775.           o    Print Parameters Submenu
  1776.           o    File Format Parameters Submenu
  1777.           o    Other Parameters Submenu
  1778.           o    Save New Setup
  1779.  
  1780.           The last entry  saves the  new parameter setup  in the  program's
  1781.           executable file.
  1782.  
  1783.  
  1784.  
  1785.  
  1786.  
  1787.  
  1788.  
  1789.  
  1790.  
  1791.  
  1792.  
  1793.  
  1794.  
  1795.  
  1796.  
  1797.  
  1798.  
  1799.  
  1800.  
  1801.  
  1802.  
  1803.  
  1804.  
  1805.  
  1806.  
  1807.  
  1808.  
  1809.  
  1810.  
  1811.  
  1812.  
  1813.  
  1814.  
  1815.  
  1816.                                           23
  1817.  
  1818.  
  1819.  
  1820.  
  1821.  
  1822.  
  1823.  
  1824.           3.1.  Display Attributes/Colors Submenu.
  1825.  
  1826.           The Display Attributes/Colors Submenu facilitates the customizing
  1827.           of  colors  or  attributes  for  the  nine  display  elements  of
  1828.           VersaEdit.  There  are three sets of  attribute/color parameters,
  1829.           one for each of the following:
  1830.  
  1831.           o    Systems equipped with a standard IBM Monochrome Display     
  1832.                Adapter (MDA) or equivalent.
  1833.  
  1834.           o    Systems equipped with a standard IBM Color/Graphics  Adapter
  1835.                (CGA) or equivalent with a monochrome monitor.
  1836.  
  1837.           o    Systems  equipped with  a  CGA or  equivalent  with a  color
  1838.                monitor.
  1839.  
  1840.           The Color parameter applies only to the systems that are equipped
  1841.           with  a CGA or  equivalent.  It  determines which attribute/color
  1842.           set  is  used.   It alternates  between  "ON", "OFF",  and "DFLT"
  1843.           (default) settings.   When the  Color parameter  is set to  "ON",
  1844.           VersaEdit uses the attribute/color set that is configured for the
  1845.           CGA systems with  a color monitor.  When set  to "OFF", VersaEdit
  1846.           uses  the attribute/color  set  that is  configured  for the  CGA
  1847.           systems with a monochrome monitor.  When set to "DFLT", VersaEdit
  1848.           determines which set to use based on the value of the screen mode
  1849.           parameter, which is maintained by  DOS.  The value of  the screen
  1850.           mode parameter is not  a reliable indicator of the  monitor type.
  1851.           Some programs change the value of this parameter and do not reset
  1852.           it.   Hence,  it is a  good practice  to set the  Color parameter
  1853.           either to "ON" or "OFF". 
  1854.  
  1855.           The colors or  attributes of each display  element can be  set by
  1856.           moving the menu bar to its  entry on the submenu, pressing Enter,
  1857.           and replying to the prompts for the background and the foreground
  1858.           color/attribute codes.The available  codes are  displayed to  the
  1859.           left of the menu.  They are:
  1860.  
  1861.                 0 -- Black
  1862.                 1 -- Blue
  1863.                 2 -- Green
  1864.                 3 -- Cyan
  1865.                 4 -- Red
  1866.                 5 -- Magenta
  1867.                 6 -- Brown
  1868.                 7 -- White
  1869.                 8 -- Gray
  1870.                 9 -- Light Blue
  1871.                10 -- Light Green
  1872.                11 -- Light Cyan
  1873.  
  1874.  
  1875.  
  1876.  
  1877.                                           24
  1878.  
  1879.  
  1880.  
  1881.  
  1882.  
  1883.  
  1884.  
  1885.  
  1886.                12 -- Light Red
  1887.                13 -- Light Magenta
  1888.                14 -- Yellow
  1889.                15 -- Intense White
  1890.  
  1891.           The VersaEdit display  elements, as  they appear  on the  Display
  1892.           Attributes/Colors Submenu, are:
  1893.  
  1894.           o    Standard Text
  1895.           o    Standard Message Line
  1896.           o    Other Message Line
  1897.           o    Menu/Help Text
  1898.           o    Menu Selector
  1899.           o    Frames
  1900.           o    Block Highlighting
  1901.           o    Tab and EOL Marks
  1902.           o    Parm Values On Menu.
  1903.  
  1904.  
  1905.  
  1906.  
  1907.  
  1908.  
  1909.  
  1910.  
  1911.  
  1912.  
  1913.  
  1914.  
  1915.  
  1916.  
  1917.  
  1918.  
  1919.  
  1920.  
  1921.  
  1922.  
  1923.  
  1924.  
  1925.  
  1926.  
  1927.  
  1928.  
  1929.  
  1930.  
  1931.  
  1932.  
  1933.  
  1934.  
  1935.  
  1936.  
  1937.  
  1938.                                           25
  1939.  
  1940.  
  1941.  
  1942.  
  1943.  
  1944.  
  1945.  
  1946.           3.2.  Other Display Parameters Submenu.
  1947.  
  1948.                               Initial
  1949.           Command Name        Defaults    Command Function
  1950.           --------------    ------------  --------------------------------
  1951.  
  1952.  
  1953.           Display    Line       OFF       Controls the startup default line
  1954.           Numbers                         number  display  (ON/OFF).    The
  1955.                                           line  number  display  depends on
  1956.                                           the file format.
  1957.  
  1958.           Visible TAB/EOL       OFF       Controls  the  visibility  of the
  1959.           Marks                           Tab and the End of Line marks.
  1960.  
  1961.           Cursor Size           DFLT      Determines   the   size   of  the
  1962.                                           cursor.   The size of  the cursor
  1963.                                           is  defined in  terms of  the top
  1964.                                           and  bottom  scan line.    On CGA
  1965.                                           systems the values of  scan lines
  1966.                                           can be between  0 and 7.   On MDA
  1967.                                           systems the values can range from
  1968.                                           0 to  13.    The  DFLT  (default)
  1969.                                           setting retains the  size of  the
  1970.                                           cursor  that  was  in  effect  at
  1971.                                           startup.
  1972.  
  1973.           TAB     Display        16       The ASCII code for  the character
  1974.           Character                       that represents a TAB mark on the
  1975.                                           screen.
  1976.  
  1977.           EOL     Display        17       The ASCII code for  the character
  1978.           Character                       that  represents  an End  of Line
  1979.                                           mark on the screen.
  1980.  
  1981.           Paging Overlap        20%       Determines the size  of the  text
  1982.                                           overlap for the Page  Up and Page
  1983.                                           Down commands.
  1984.  
  1985.           Side     Scroll       75%       Determines the size  of the  text
  1986.           Overlap                         side shift overlap.
  1987.  
  1988.                             ... Continued on Next Page ...
  1989.  
  1990.                        Table 3.2.1.  Other Display Parameters.
  1991.  
  1992.  
  1993.  
  1994.  
  1995.  
  1996.  
  1997.  
  1998.  
  1999.                                           26
  2000.  
  2001.  
  2002.  
  2003.  
  2004.  
  2005.  
  2006.  
  2007.                               Initial
  2008.           Command Name        Defaults    Command Function
  2009.           --------------    ------------  --------------------------------
  2010.  
  2011.  
  2012.                          ...Continued from Previous Page ...
  2013.  
  2014.           EGA   Rows   at       DFLT      Determines the number of  rows to
  2015.           Startup                         be  used  for  an   EGA  equipped
  2016.                                           system.    The  value  alternates
  2017.                                           between  DFLT  (default)  and 43.
  2018.                                           When  this  parameter  is set  to
  2019.                                           DFLT, VersaEdit will  come up  in
  2020.                                           the number  of rows  that are  in
  2021.                                           effect at startup.  Otherwise, it
  2022.                                           will come up in 43 rows.
  2023.  
  2024.           Vertical Screen        ON       Controls   the  startup   default
  2025.           Split                           method for forming  the new  text
  2026.                                           windows.  When  "ON", the  screen
  2027.                                           is  split  both   vertically  and
  2028.                                           horizontally.    Otherwise,   the
  2029.                                           screen     is      split     only
  2030.                                           horizontally.
  2031.  
  2032.           Suppress "Snow"        ON       Determines   the  screen   update
  2033.                                           mode.   When "ON", the  screen is
  2034.                                           updated using a slower  method to
  2035.                                           prevent  the  screen   "snow"  or
  2036.                                           flickering.  This applies only to
  2037.                                           the CGA equipped systems.
  2038.  
  2039.                         Table 3.2.1  Other Display Parameters.
  2040.  
  2041.  
  2042.  
  2043.  
  2044.  
  2045.  
  2046.  
  2047.  
  2048.  
  2049.  
  2050.  
  2051.  
  2052.  
  2053.  
  2054.  
  2055.  
  2056.  
  2057.  
  2058.  
  2059.  
  2060.                                           27
  2061.  
  2062.  
  2063.  
  2064.  
  2065.  
  2066.  
  2067.  
  2068.           3.3.  Print Parameters Submenu.
  2069.  
  2070.           VersaEdit prints  a header  line at the  top of  each page.   The
  2071.           header line includes the file name,  date, time, and page number.
  2072.           The  line  length,  page size,  spacing,  and  inclusion  of line
  2073.           numbers  is  controlled   by  the   print  parameters  shown   in
  2074.           Table 3.3.1
  2075.  
  2076.                               Initial
  2077.           Command Name        Defaults    Command Function
  2078.           --------------    ------------  --------------------------------
  2079.  
  2080.  
  2081.           Line Length            80       Number of  characters per line.
  2082.  
  2083.           Page Size              66       Page size in number of lines.
  2084.  
  2085.           Spacing                1        Line spacing.
  2086.  
  2087.           Include    Line        ON       Print  numbered/unnumbered toggle
  2088.           Numbers                         switch.
  2089.  
  2090.           Initial/Final         FINL      Controls page ejects.  Alternates
  2091.           Page Eject                      between   INIT  (initial),   FINL
  2092.                                           (final), BOTH, and NONE.
  2093.  
  2094.                            Table 3.3.1.  Print Parameters.
  2095.  
  2096.  
  2097.  
  2098.  
  2099.  
  2100.  
  2101.  
  2102.  
  2103.  
  2104.  
  2105.  
  2106.  
  2107.  
  2108.  
  2109.  
  2110.  
  2111.  
  2112.  
  2113.  
  2114.  
  2115.  
  2116.  
  2117.  
  2118.  
  2119.  
  2120.  
  2121.                                           28
  2122.  
  2123.  
  2124.  
  2125.  
  2126.  
  2127.  
  2128.  
  2129.           3.4.  File Formatting Parameters Submenu.
  2130.  
  2131.           The file formatting parameters control the formatting of files in
  2132.           order to conform to the  specific computer language requirements.
  2133.           VersaEdit  accommodates  five  file  formats.   The  formats  are
  2134.           defined in terms of the following parameters:
  2135.  
  2136.           o    File Format Number 
  2137.           o    Line Number Length
  2138.           o    Output Line Numbers (on/off)
  2139.           o    Strip Line Numbers on Input (on/off)
  2140.           o    Blank Space After Line Number (on/off)
  2141.           o    First Tab Column
  2142.           o    Tab Length
  2143.           o    Replace Tabs By Spaces on Output (on/off)
  2144.           o    Replace Initial Spaces By Tabs on Input (on/off)
  2145.           o    File Name Extension
  2146.  
  2147.           The File Format Number identifies the  file format to be modified
  2148.           (1 - 5).
  2149.  
  2150.           VersaEdit does not  internally store  the line numbers.   A  line
  2151.           number simply indicates  the position of  a line relative to  the
  2152.           beginning of the file.  The line numbers can be displayed  on the
  2153.           screen and/or written to the output file.
  2154.  
  2155.           The Line Number Length  parameter defines the length of  the line
  2156.           number for display and/or output.
  2157.  
  2158.           The Output  Line  Numbers parameter  is an  on/off toggle  switch
  2159.           indicating whether  to include  the  line numbers  in the  output
  2160.           file.
  2161.  
  2162.           The Strip Line  Numbers on  Input parameter is  an on/off  toggle
  2163.           switch indicating whether to strip the line numbers during input.
  2164.           Since  the line numbers are not internally stored, this parameter
  2165.           must be "ON" if  Output Line Numbers parameter is "ON".   Both of
  2166.           these  parameters  are set  to  "ON"  for the  default  COBOL and
  2167.           FORTRAN formats.The Blank  Space After the Line  Number parameter
  2168.           is an on/off toggle switch indicating  whether to include a blank
  2169.           space after  the line  number for  display and/or  output.   This
  2170.           parameter is set to "OFF" for the COBOL and FORTRAN formats.   It
  2171.           should be set to "ON" for most of the other languages.
  2172.  
  2173.           The  First Tab  Column parameter  indicates  the position  of the
  2174.           first tab column.  It is defined as 8 for the COBOL format and as
  2175.           7  for  FORTRAN.   It  should  be  defined as  4  for  most other
  2176.           languages.
  2177.  
  2178.           The Tab Length  parameter defines  the standard column  increment
  2179.           for  a tab mark.   It is generally set  to 4, except for FORTRAN,
  2180.           where it is set to 5.
  2181.  
  2182.                                           29
  2183.  
  2184.  
  2185.  
  2186.  
  2187.  
  2188.  
  2189.  
  2190.           The  Replace  Tabs by  Spaces on  Output  parameter is  an on/off
  2191.           toggle switch indicating whether to replace tabs by spaces during
  2192.           output.  This parameter should be set to "ON" for languages  that
  2193.           have difficulties with tab marks or are format sensitive, such as
  2194.           COBOL or FORTRAN.
  2195.  
  2196.           The Replace Initial Spaces by Tabs  parameter is an on/off toggle
  2197.           switch  indicating whether to replace the  initial spaces in each
  2198.           line by tab marks during input.  It should be set to "ON", if the
  2199.           previous parameter is set to "ON".
  2200.  
  2201.           The File Name Extension parameter identifies the file name
  2202.           extension  that  is associated  with  the current  format number.
  2203.           VersaEdit  assigns  the  file  format  based  on  the  file  name
  2204.           extension.  The file name extension  cannot be assigned to format
  2205.           1, because it is the default format.
  2206.  
  2207.           Table 3.4.1 shows the initial file format parameter settings.
  2208.  
  2209.           Format 1 is the default format, that is, if a file name extension
  2210.           does not match  any of the extensions  in the table,  this format
  2211.           will be used.  It is setup for the free format languages, such as
  2212.           "C"  or  Assembler.   The line  numbers can  be displayed  on the
  2213.           screen, but are not output to the program file.  The program file
  2214.           can contain tab marks.  A blank space is included after each line
  2215.           number  for  display purposes  only.   The  tab columns  start at
  2216.           column 4 and are spaced at increments of 4.  This  format results
  2217.           in the fastest I/O, since no reformatting takes place.
  2218.  
  2219.           Format 2 is configured for COBOL.  The line number length  is set
  2220.           to 6.  The line numbers  are included in the output file  and are
  2221.           stripped when the  file is read in.   No blank space  is inserted
  2222.           after  the  line  number, since  column  7  is  used for  special
  2223.           purposes.    The first  tab  column is  set to  8  to accommodate
  2224.           effective  use of the Auto Indent  feature of VersaEdit.  The tab
  2225.           length is set to 4, to conform to the COBOL format  requirements.
  2226.           The tab marks are replaced by spaces  in the output process.  The
  2227.           initial spaces are  replaced by tab  marks in the input  process.
  2228.           Any file  with the extension of  "COB" will be processed  in this
  2229.           format.
  2230.  
  2231.           Format 3  is configured for  the versions of  BASIC that use  the
  2232.           line numbers as goto  labels.  It is set up  to totally eliminate
  2233.           the use  of  VersaEdit  generated  line numbers  in  display  and
  2234.           output.  Hence,  the user must  enter the line numbers  manually.
  2235.           The tab marks are replaced by spaces  in the output process.  The
  2236.           initial spaces are replaced by tab marks in the input process.
  2237.  
  2238.           Format 4 is configured for FORTRAN.  It is identical to the COBOL
  2239.           format, except that the first tab column is set to 7, and the tab
  2240.           length is set to 5.
  2241.  
  2242.  
  2243.                                           30
  2244.  
  2245.  
  2246.  
  2247.  
  2248.  
  2249.  
  2250.  
  2251.           Format 5 is an additional format, to be used if there is a need.
  2252.  
  2253.           VersaEdit will  accept some contradictory file  format parameters
  2254.           in  order  to  accommodate  file   reformatting.    Contradictory
  2255.           parameters, however, should not be saved.
  2256.  
  2257.                                           Parameter Values by Format Number
  2258.                                           ---------------------------------
  2259.           Format Parameters                 1      2      3      4      5
  2260.           -----------------------------   -----  -----  -----  -----  -----
  2261.  
  2262.  
  2263.           Line Number Length                5      6      0      5      5
  2264.  
  2265.           Output Line Numbers               no    yes     no    yes    yes
  2266.  
  2267.           Strip Line Numbers On Input       no    yes     no    yes    yes
  2268.  
  2269.           Blank Space After Line Number    yes     no    N/A     no    yes
  2270.  
  2271.           First Tab Column                  5      8      7      7      7
  2272.  
  2273.           Tab Length                        4      4      4      5      4
  2274.  
  2275.           Replace Initial Spaces By Tabs    no    yes    yes    yes    yes
  2276.           On Input
  2277.  
  2278.           Replace  Tabs  By   Spaces  On    no    yes    yes    yes    yes
  2279.           Output
  2280.  
  2281.           File Name Extension             "N/A"  "COB"  "BAS"  "FOR"  "***"
  2282.  
  2283.                 Table 3.4.1.  Initial File Format Parameter Settings.
  2284.  
  2285.  
  2286.  
  2287.  
  2288.  
  2289.  
  2290.  
  2291.  
  2292.  
  2293.  
  2294.  
  2295.  
  2296.  
  2297.  
  2298.  
  2299.  
  2300.  
  2301.  
  2302.  
  2303.  
  2304.                                           31
  2305.  
  2306.  
  2307.  
  2308.  
  2309.  
  2310.  
  2311.  
  2312.           3.5.  Other Parameters Submenu.
  2313.  
  2314.                               Initial
  2315.           Command Name        Defaults    Command Function
  2316.           --------------    ------------  --------------------------------
  2317.  
  2318.  
  2319.           Insert Mode            ON       Controls    the    Insert    Mode
  2320.                                           (on/off).
  2321.  
  2322.           Auto     Indent        ON       Controls  the  Auto  Indent  Mode
  2323.           Mode                            (on/off).
  2324.  
  2325.           Letter     Case       OFF       Controls the distinction between
  2326.           Distinction                     the upper and lower  case letters
  2327.                                           in a search.
  2328.  
  2329.           Cursor   Run-on        ON       Controls   the    Cursor   Run-on
  2330.           Inhibition                      Inhibition (on/off).
  2331.  
  2332.           Default    File       NONE      Determines  the   extension  that
  2333.           Name Extension                  will be appended to  a file name,
  2334.                                           if the extension is omitted.   No
  2335.                                           extension will  be appended  when
  2336.                                           this parameter  is set to "NONE".
  2337.  
  2338.           Average    Line        24       Defines the  average line  length
  2339.           Length                          of your files.   Used in internal
  2340.                                           memory allocation.
  2341.  
  2342.           Maximum    Line       256       Defines the Maximum Line Length.
  2343.           Length
  2344.  
  2345.           Help       File     A:\E.HLP    Defines  the  Help   File  drive,
  2346.           Specification                   path, and name.
  2347.  
  2348.           E x e   F i l e     A:\E.EXE    Defines the Exe File drive, path,
  2349.           Specification                   and name.
  2350.  
  2351.                            Table 3.5.1.  Other Parameters.
  2352.  
  2353.           The cursor run-on occurs  when a program cannot keep  up with the
  2354.           inflow of characters.   This usually occurs  when a key  is being
  2355.           held down for a period of  time.  VersaEdit almost never requires
  2356.           the  cursor run-on  inhibition.   In  most cases,  this parameter
  2357.           should be set  to "OFF",  since it interferes  with the  keyboard
  2358.           macros.    If you  do  need  the cursor  run-on  inhibition, your
  2359.           keyboard macros should have delay factors wherever  there is more
  2360.           than one occurrence of the same character.
  2361.  
  2362.           The  Average  Line  Length  parameter is  used  by  VersaEdit  to
  2363.           distribute the available memory between the line pointers and the
  2364.  
  2365.                                           32
  2366.  
  2367.  
  2368.  
  2369.  
  2370.  
  2371.  
  2372.  
  2373.           text.  Use the supplied AVGLINE  program to determine the average
  2374.           line length of your files (see Section 1.4).
  2375.  
  2376.           The Maximum  Line Length parameter should be set only as large as
  2377.           necessary in order to  accommodate efficient use of memory.   The
  2378.           initial setting is 256 characters.
  2379.  
  2380.           The Help  file and  Exe file  name specifications  are needed  by
  2381.           VersaEdit to display help and to save new parameter settings.
  2382.  
  2383.  
  2384.  
  2385.  
  2386.  
  2387.  
  2388.  
  2389.  
  2390.  
  2391.  
  2392.  
  2393.  
  2394.  
  2395.  
  2396.  
  2397.  
  2398.  
  2399.  
  2400.  
  2401.  
  2402.  
  2403.  
  2404.  
  2405.  
  2406.  
  2407.  
  2408.  
  2409.  
  2410.  
  2411.  
  2412.  
  2413.  
  2414.  
  2415.  
  2416.  
  2417.  
  2418.  
  2419.  
  2420.  
  2421.  
  2422.  
  2423.  
  2424.  
  2425.  
  2426.                                           33
  2427.  
  2428.  
  2429.  
  2430.  
  2431.  
  2432.  
  2433.  
  2434.           3.6.  Save New Setup Entry.
  2435.  
  2436.           Selection of  this entry  will permanently  change the  parameter
  2437.           settings to the new  setup.  The parameter setup is  saved in the
  2438.           VersaEdit executable file.
  2439.  
  2440.  
  2441.  
  2442.  
  2443.  
  2444.  
  2445.  
  2446.  
  2447.  
  2448.  
  2449.  
  2450.  
  2451.  
  2452.  
  2453.  
  2454.  
  2455.  
  2456.  
  2457.  
  2458.  
  2459.  
  2460.  
  2461.  
  2462.  
  2463.  
  2464.  
  2465.  
  2466.  
  2467.  
  2468.  
  2469.  
  2470.  
  2471.  
  2472.  
  2473.  
  2474.  
  2475.  
  2476.  
  2477.  
  2478.  
  2479.  
  2480.  
  2481.  
  2482.  
  2483.  
  2484.  
  2485.  
  2486.  
  2487.                                           34
  2488.  
  2489.  
  2490.  
  2491.  
  2492.  
  2493.  
  2494.  
  2495.           Appendix A.    Assignment  of  Function  Keys   to  Commands,  by
  2496.                          Command Category.
  2497.  
  2498.  
  2499.           Menu Commands:                     Delete File               ^F10
  2500.                                              Directory                  sF7
  2501.           Main Menu                   F2
  2502.           File Command Menu          ^F1     Find/Replace Commands:
  2503.           Find/Replace Menu          sF1
  2504.           Cut & Paste Menu           aF1     Find String                sF2
  2505.           Utilities Menu            aF10     Find Block                 sF3
  2506.           Parameters Menu           sF10     Replace String             sF4
  2507.                                              Repeat Find/Replace        sF5
  2508.           Cut & Paste Commands:
  2509.                                              Utility Commands:
  2510.           Mark Block                 aF2
  2511.           Highlight Block            aF3     Help                        F1
  2512.           Copy Block                 aF4     Main Menu                   F2
  2513.           Delete Block               aF5     Delete Line                 F3
  2514.           Move Block                 aF6     Delete Remainder of Line    F4
  2515.           Print Block                aF7     Insert Line                 F5
  2516.           Write Block                aF8     Restore Line                F6
  2517.           Insert File                aF9     Go To Line                  F7
  2518.                                              Go To Next Window           F8
  2519.           File Commands:                     Open New Window             F9
  2520.                                              Display Line Numbers       F10
  2521.           Get File                   ^F2     Reset Disk                 sF8
  2522.           Release File               ^F3     Memory Status              sF6
  2523.           Save Release               ^F4     Summary Display            sF9
  2524.           Save Bak Release           ^F5     Auto Indent                 aA
  2525.           Save Only                  ^F6     Find Balancing Parenthesis  aB
  2526.           Write File                 ^F7     Contract Window             aC
  2527.           Print File                 ^F8     Expand Window               aE
  2528.           Rename File                ^F9     DOS Gateway                 aD
  2529.                                              Vertical Screen Split       aV
  2530.  
  2531.  
  2532.  
  2533.  
  2534.  
  2535.  
  2536.  
  2537.  
  2538.  
  2539.  
  2540.  
  2541.  
  2542.  
  2543.  
  2544.  
  2545.  
  2546.  
  2547.  
  2548.                                           35
  2549.  
  2550.  
  2551.  
  2552.  
  2553.  
  2554.  
  2555.  
  2556.           Appendix B.    Assignment of Function Keys to Commands, by Key.
  2557.  
  2558.                                              aF5  Delete Block
  2559.           F1   Help                          aF6  Move Block
  2560.           F2   Main Menu                     aF7  Print Block
  2561.           F3   Delete Line                   aF8  Write Block
  2562.           F4   Delete Remainder of Line      aF9  Insert File
  2563.           F5   Insert Line                   aF10 Utilities Menu
  2564.           F6   Restore Line                  sF1  Find/Replace Menu
  2565.           F7   Go To Line #                  sF2  Find String
  2566.           F8   Go To Next Window             sF3  Find Block
  2567.           F9   Open New Window               sF4  Replace String
  2568.           F10  Display Line Numbers          sF5  Repeat Find/Replace
  2569.           ^F1  File Command Menu             sF6  Display Memory Status
  2570.           ^F2  Get File                      sF7  File Directory
  2571.           ^F3  Release File                  sF8  Reset Disk Drives
  2572.           ^F4  Save Release                  sF9  Summary Display
  2573.           ^F5  Save Bak Release              sF10 Parameters Menu
  2574.           ^F6  Save Only                     aA   Auto Indent (on/off)
  2575.           ^F7  Write File                    aB   Find            Balancing
  2576.           ^F8  Print File                         Parenthesis
  2577.           ^F9  Rename File                   aC   Contract Window
  2578.           ^F10 Delete File                   aD   DOS Gateway
  2579.           aF1  Cut & Paste Menu              aE   Expand Window
  2580.           aF2  Mark Block                    aV   Vertical Screen Split
  2581.           aF3  Highlight Block
  2582.           aF4  Copy Block
  2583.  
  2584.  
  2585.  
  2586.  
  2587.  
  2588.  
  2589.  
  2590.  
  2591.  
  2592.  
  2593.  
  2594.  
  2595.  
  2596.  
  2597.  
  2598.  
  2599.  
  2600.  
  2601.  
  2602.  
  2603.  
  2604.  
  2605.  
  2606.  
  2607.  
  2608.  
  2609.                                           36
  2610.  
  2611.  
  2612.  
  2613.  
  2614.  
  2615.  
  2616.  
  2617.                                         Index.
  2618.  
  2619.  
  2620.           ^F1 . . . . . . . . . . . . . . . . . . . . . . . . 2, 11, 35, 36
  2621.           ^F10  . . . . . . . . . . . . . . . . . . . . . . . .  15, 35, 36
  2622.           ^F2 . . . . . . . . . . . . . . . . . . . . . . . . .  15, 35, 36
  2623.           ^F3 . . . . . . . . . . . . . . . . . . . . . . . . .  15, 35, 36
  2624.           ^F4 . . . . . . . . . . . . . . . . . . . . . . . . .  15, 35, 36
  2625.           ^F5 . . . . . . . . . . . . . . . . . . . . . . . . .  15, 35, 36
  2626.           ^F6 . . . . . . . . . . . . . . . . . . . . . . . . .  15, 35, 36
  2627.           ^F7 . . . . . . . . . . . . . . . . . . . . . . . . .  15, 35, 36
  2628.           ^F8 . . . . . . . . . . . . . . . . . . . . . . . . .  15, 35, 36
  2629.           ^F9 . . . . . . . . . . . . . . . . . . . . . . . . .  15, 35, 36
  2630.           aA  . . . . . . . . . . . . . . . . . . . . . . 6, 10, 21, 35, 36
  2631.           aB  . . . . . . . . . . . . . . . . . . . . . . . . 6, 21, 35, 36
  2632.           aC  . . . . . . . . . . . . . . . . . . . . . . . . 6, 21, 35, 36
  2633.           aD  . . . . . . . . . . . . . . . . . . . . . . . . 6, 21, 35, 36
  2634.           aE  . . . . . . . . . . . . . . . . . . . . . . . . 6, 21, 35, 36
  2635.           aF1 . . . . . . . . . . . . . . . . . . . . . . . . 2, 11, 35, 36
  2636.           aF10  . . . . . . . . . . . . . . . . . . . . . . . .  11, 35, 36
  2637.           aF2 . . . . . . . . . . . . . . . . . . . . . . . . .  20, 35, 36
  2638.           aF4 . . . . . . . . . . . . . . . . . . . . . . . . .  20, 35, 36
  2639.           aF5 . . . . . . . . . . . . . . . . . . . . . . . . .  20, 35, 36
  2640.           aF6 . . . . . . . . . . . . . . . . . . . . . . . . .  20, 35, 36
  2641.           aF7 . . . . . . . . . . . . . . . . . . . . . . . . .  20, 35, 36
  2642.           aF8 . . . . . . . . . . . . . . . . . . . . . . . . .  20, 35, 36
  2643.           aF9 . . . . . . . . . . . . . . . . . . . . . . .  15, 20, 35, 36
  2644.           Auto Indent . . . . . . . . . . . .  2, 6, 10, 21, 30, 32, 35, 36
  2645.           aV  . . . . . . . . . . . . . . . . . . . . . . . . 6, 21, 35, 36
  2646.           Contract Window . . . . . . . . . . . . . . . . . . 6, 21, 35, 36
  2647.           Copy Block  . . . . . . . . . . . . . . . . . . . . .  20, 35, 36
  2648.           Cut & Paste Menu  . . . . . . . . . . . . . . . . . .  11, 35, 36
  2649.           Delete Block  . . . . . . . . . . . . . . . . . . . .  20, 35, 36
  2650.           Delete File . . . . . . . . . . . . . . . . . . .  15, 16, 35, 36
  2651.           Delete Line . . . . . . . . . . . . . . . . . . . . .  10, 35, 36
  2652.           Delete Remainder of Line  . . . . . . . . . . . . . .  10, 35, 36
  2653.           Directory . . . . . . . . . . . . . . . . 1, 3, 4, 15, 16, 35, 36
  2654.           Display Line Numbers  . . . . . . . . . . . .  21, 22, 26, 35, 36
  2655.           DOS Gateway . . . . . . . . . . . . . . . .  2, 6, 21, 22, 35, 36
  2656.           Expand Window . . . . . . . . . . . . . . . . . 6, 21, 22, 35, 36
  2657.           F1  . . . . . . . . . . . . . . . . . . . 2, 5, 7, 11, 13, 35, 36
  2658.           F10 . . . . . . . . . . . . . . . . . . . . . . .  15, 21, 35, 36
  2659.           F2  . . . . . . . . . . . . . . .  5-7, 11, 13, 15, 17-19, 35, 36
  2660.           F3  . . . . . . . . . . . . . . . . . . .  10, 13, 15, 19, 35, 36
  2661.           F4  . . . . . . . . . . . . . . . . . . .  10, 13, 15, 19, 35, 36
  2662.           F5  . . . . . . . . . . . . . . . . . . . . 10, 13-15, 19, 35, 36
  2663.           F6  . . . . . . . . . . . . . . . . .  13, 15, 17, 19, 21, 35, 36
  2664.           F7  . . . . . . . . . . . . . . . . 9, 13, 15, 17, 19, 21, 35, 36
  2665.           F8  . . . . . . . . . . . . . . . . .  13, 15, 17, 19, 21, 35, 36
  2666.           F9  . . . . . . . . . . . . . . . . . . .  13, 15, 17, 21, 35, 36
  2667.           File Command Menu . . . . . . . . . . . . . . . . . .  11, 35, 36
  2668.           Find Balancing Parenthesis  . . . . . . . . . . . . 6, 21, 35, 36
  2669.  
  2670.                                           37
  2671.  
  2672.  
  2673.  
  2674.  
  2675.  
  2676.  
  2677.  
  2678.           Find Block  . . . . . . . . . . . . . . . . . . .  17, 18, 35, 36
  2679.           Find String . . . . . . . . . . . . . . . . . . .  17, 18, 35, 36
  2680.           Find/Replace Menu . . . . . . . . . . . . . . . . . .  11, 35, 36
  2681.           Get File  . . . . . . . . . . . . . . . . . . .  3, 14-16, 35, 36
  2682.           Go To Line  . . . . . . . . . . . . . . . . . . . . 9, 21, 35, 36
  2683.           Help  . . . . . . . . . 1, 3-5, 7, 11, 13, 14, 25, 32, 33, 35, 36
  2684.           Highlight Block . . . . . . . . . . . . . . . . . . .  20, 35, 36
  2685.           Insert File . . . . . . . . . . . . . . . . .  15, 16, 20, 35, 36
  2686.           Insert Line . . . . . . . . . . . . . . . . . . . . .  10, 35, 36
  2687.           Main Menu . . . . . . . . . . . . . . . . . . . 7, 11, 23, 35, 36
  2688.           Mark Block  . . . . . . . . . . . . . . . . . . . . .  20, 35, 36
  2689.           Memory Status . . . . . . . . . . . . . . . . . . . .  21, 35, 36
  2690.           Move Block  . . . . . . . . . . . . . . . . . . . . .  20, 35, 36
  2691.           Open New Window . . . . . . . . . . . . . . . . . . .  21, 35, 36
  2692.           Parameters Menu . . . . . . . . . . . . . 3-5, 11, 16, 23, 35, 36
  2693.           Print Block . . . . . . . . . . . . . . . . . . . . .  20, 35, 36
  2694.           Print File  . . . . . . . . . . . . . . . . . . .  15, 16, 35, 36
  2695.           Release File  . . . . . . . . . . . . . . . . . . . .  15, 35, 36
  2696.           Rename File . . . . . . . . . . . . . . . . . . .  15, 16, 35, 36
  2697.           Repeat Find/Replace . . . . . . . . . . . . . . .  17, 18, 35, 36
  2698.           Replace String  . . . . . . . . . . . . . . . . .  17, 18, 35, 36
  2699.           Reset Disk  . . . . . . . . . . . . . . . . . . . . .  21, 35, 36
  2700.           Restore Line  . . . . . . . . . . . . . . . . . . . .  21, 35, 36
  2701.           Save Bak Release  . . . . . . . . . . . . . . . .  15, 16, 35, 36
  2702.           Save Only . . . . . . . . . . . . . . . . . . . . . .  15, 35, 36
  2703.           Save Release  . . . . . . . . . . . . . . . . . . . .  15, 35, 36
  2704.           sF1 . . . . . . . . . . . . . . . . . . . . . . . . 2, 11, 35, 36
  2705.           sF10  . . . . . . . . . . . . . . . . . . . . . 4, 11, 23, 35, 36
  2706.           sF2 . . . . . . . . . . . . . . . . . . . . . . . . .  17, 35, 36
  2707.           sF3 . . . . . . . . . . . . . . . . . . . . . . . . .  17, 35, 36
  2708.           sF4 . . . . . . . . . . . . . . . . . . . . . . . . .  17, 35, 36
  2709.           sF5 . . . . . . . . . . . . . . . . . . . . . . . . .  17, 35, 36
  2710.           sF6 . . . . . . . . . . . . . . . . . . . . . . . . .  21, 35, 36
  2711.           sF7 . . . . . . . . . . . . . . . . . . . . . . . . .  15, 35, 36
  2712.           sF8 . . . . . . . . . . . . . . . . . . . . . . . . .  21, 35, 36
  2713.           sF9 . . . . . . . . . . . . . . . . . . . . . . . . .  21, 35, 36
  2714.           Summary Display . . . . . . . . . . . . . . . . 2, 21, 22, 35, 36
  2715.           Utilities Menu  . . . . . . . . . . . . . . . . . . .  11, 35, 36
  2716.           Vertical Screen Split . . . . . . . . . . . 6, 21, 22, 27, 35, 36
  2717.           Write Block . . . . . . . . . . . . . . . . . . . . .  20, 35, 36
  2718.           Write File  . . . . . . . . . . . . . . . . . . . . .  15, 35, 36
  2719.  
  2720.  
  2721.  
  2722.  
  2723.  
  2724.  
  2725.  
  2726.  
  2727.  
  2728.  
  2729.  
  2730.  
  2731.                                           38
  2732.